﻿<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>YBA.Common.timer</title>
    <link href="../default.css" rel="stylesheet" type="text/css" />
</head>
<body>
    <h1>YBA.Common.timer(time,<i>[onTicking]</i>,<i>[ended]</i>)</h1>
    <h2>概述</h2>
    <p>
        倒计时，提供两种形式的倒计时功能。1、只有秒的倒计时 2、传入天、时、分、秒的倒计时
    </p>
    <h2>参数说明</h2>
    <h3>time:对象表达式</h3>
    <p>
        <pre>
    {
        d:天,
        h:时,
        m:分,
        s:秒,
        format:"json" // format表示返回值形式，传入"json"则返回{d:天,h:时,m:分,s:秒}，否则直接返回剩余数值
    }
        </pre>
    </p>
    <h3>onTicking:回调函数,(<i>可选</i>)</h3>
    <p>
        倒计时中的回调函数，每倒数1秒就执行一次，回调函数的上下文对象this指向了内部的计时器i，可在回调函数内部使用clearInterval(this)提前结束计时
    </p>
    <h3>ended:回调函数,(<i>可选</i>)</h3>
    <p>
        倒计时结束后执行的回调函数，回调函数的上下文对象this指向了内部的计时器i，可在回调函数内部使用clearInterval(this)提前结束计时
    </p>
    <h2>返回值</h2>
    <p>
        根据传入的time.format不同，有2种返回值<br />
        1、time.format="json",返回值为{d:天,h:时,m:分,s:秒}<br />
        2、不传入time.format,返回值为数字
    </p>
    <h2>示例代码</h2>
    <p>
        <pre>
    //倒计时，1天1小时10分20秒并传入了format="json"，第一次的返回值是{d,1,h:1,m:10,s:19}
    YBA.Common.timer({d:1,h:1,m:10,s:20,format:"json"},function(time){
        alert(time.d+":"+time.h+":"+time.m+":"+time.s);
    },function(time){
        alert("倒计时结束");
    });

    //倒计时，120秒，未传入format，第一次的返回值是数字119
    YBA.Common.timer({s:120},function(time){
        alert(time);
    },function(time){
        alert("倒计时结束");
    });
        </pre>
    </p>
</body>
</html>
